package org.goodsmanager.service;

import org.goodsmanager.entity.Order;
import org.goodsmanager.entity.OrderItem;

import java.util.List;
import java.util.Map;

/**
 * 订单服务接口
 */
public interface OrderService {
    
    /**
     * 创建订单
     * @param order 订单信息
     * @param cartItems 购物车商品列表
     * @return 创建的订单
     */
    Order createOrder(Order order, List<org.goodsmanager.entity.Cart> cartItems);
    
    /**
     * 根据ID查询订单
     * @param id 订单ID
     * @return 订单信息
     */
    Order getOrderById(Long id);
    
    /**
     * 根据订单号查询订单
     * @param orderNumber 订单号
     * @return 订单信息
     */
    Order getOrderByOrderNumber(String orderNumber);
    
    /**
     * 根据用户ID查询订单列表
     * @param userId 用户ID
     * @return 订单列表
     */
    List<Order> getOrdersByUserId(Long userId);
    
    /**
     * 根据用户ID和状态查询订单列表
     * @param userId 用户ID
     * @param status 订单状态
     * @return 订单列表
     */
    List<Order> getOrdersByUserIdAndStatus(Long userId, String status);
    
    /**
     * 更新订单状态
     * @param id 订单ID
     * @param status 新状态
     * @return 是否成功
     */
    boolean updateOrderStatus(Long id, String status);
    
    /**
     * 更新订单支付信息
     * @param id 订单ID
     * @param paymentMethod 支付方式
     * @param paymentId 支付ID
     * @return 是否成功
     */
    boolean updateOrderPayment(Long id, String paymentMethod, String paymentId);
    
    /**
     * 更新订单物流信息
     * @param id 订单ID
     * @param trackingNumber 物流单号
     * @return 是否成功
     */
    boolean updateOrderTracking(Long id, String trackingNumber);
    
    /**
     * 取消订单
     * @param id 订单ID
     * @return 是否成功
     */
    boolean cancelOrder(Long id);
    
    /**
     * 删除订单
     * @param id 订单ID
     * @return 是否成功
     */
    boolean deleteOrder(Long id);
    
    /**
     * 统计用户订单数量
     * @param userId 用户ID
     * @return 订单数量
     */
    int countOrdersByUserId(Long userId);
    
    /**
     * 统计用户各状态订单数量
     * @param userId 用户ID
     * @return 状态-数量映射
     */
    Map<String, Integer> countOrdersByStatus(Long userId);
    
    /**
     * 生成订单号
     * @return 订单号
     */
    String generateOrderNumber();
}